Skip to content

ci: Add redirect target validator, fix 18 broken redirects#1093

Merged
louis-pre merged 11 commits into
mainfrom
ci/validate-redirects
Apr 22, 2026
Merged

ci: Add redirect target validator, fix 18 broken redirects#1093
louis-pre merged 11 commits into
mainfrom
ci/validate-redirects

Conversation

@louis-pre

Copy link
Copy Markdown
Member

Summary

  • Adds validate-redirects CI check that verifies all .gitbook.yaml redirect targets resolve to existing pages
  • Fixes 18 broken redirect targets — old URLs were silently producing 404s

Fixes applied

Category Count Fix
Wrong prefix (latest/, api-clients/) 3 Corrected to valid path
Page restructured (README.md → flat file) 2 Updated to new path
Page removed (credential-types, delete, get endpoints) 13 Redirected to parent page

Test plan

  • npm run validate-redirects passes
  • npm run validate-paths passes
  • npm run validate-links passes
  • npm run typecheck passes

🤖 Generated with Claude Code

@louis-pre louis-pre requested a review from a team as a code owner April 22, 2026 08:02
louis-pre and others added 3 commits April 22, 2026 01:11
Add validate-redirects CI check that verifies all .gitbook.yaml
redirect targets resolve to existing pages. Fix 18 broken targets
caused by pages being moved or removed over time.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
GitBook resolves README.md in redirect targets as directory URLs, so
these don't need to be changed. Update the validator to accept
foo/README.md when foo.md exists as the page file.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@louis-pre louis-pre force-pushed the ci/validate-redirects branch from d4a23d7 to 076e084 Compare April 22, 2026 08:11
@louis-pre louis-pre marked this pull request as draft April 22, 2026 18:18
louis-pre and others added 5 commits April 22, 2026 11:29
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…idator

Redirect targets should always point to exact files.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Replace bare directory targets with explicit README.md paths and
update the validator to reject directories.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@louis-pre louis-pre marked this pull request as ready for review April 22, 2026 18:54
louis-pre and others added 3 commits April 22, 2026 11:55
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@louis-pre louis-pre merged commit df9fde6 into main Apr 22, 2026
10 checks passed
@louis-pre louis-pre deleted the ci/validate-redirects branch April 22, 2026 19:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants